LEGION Simulator Help

Specifying Filter Settings

Objects that filter have a tabbed page on their Edit <object name> dialog called Entity Filters, where filtering settings can be set.
Tip: Filtering objects automatically filter for All Entities until you change their settings.

The following procedure assumes that a filtering object is already drawn. It deals with Standard filter settings; Advanced filter settings are covered in the Advanced Filtering topic in LEGION Simulator help.

To specify filter settings:

  1. Right-click on the object and select Edit Properties.
    • The Edit <object name> dialog is displayed (in this example, it is the Edit Direction Modifier dialog.)
  2. Click on the Entity Filter tab.
  3. To use an existing Named Filter, select the Named Filter option and choose a filter from the drop-down list. Then click OK to finish and save these filter settings. If there are no Named Filters, either create them as described in Creating Named Filters, or continue from step 4.
  4. From the drop-down list labelled Filtering Method, select one of the three options:
    • All – all Entities in the model will be affected (click OK)
    • None – no Entities in the model will be affected (click OK)
    • Selected attributes – allows definition of precise filtering criteria
  5. If choosing the third option above, select attributes from the five categories of Activity, Entity Type, Final Destination, Origin and Target.
    • To do this, expand the tree of available attributes as needed and move them into the selected pane using the > and >> buttons (to remove selected attributes, use < and <<).
      Tip: The selected tree is automatically expanded when the property dialog is shown, when something new is added, and when switching from Advanced to Standard filtering.
      Tip: If you selected Target and wish to choose a Gate object, ensure that you select the correct Gate Side (IN or OUT). A Gate may have a unique name but two sides if it is a Switch Gate.
  6. From the drop-down list labelled Logic method, select one of the following:
    • o AND – only Entities with every selected attribute will be affected
    • o OR – Entities with any of the selected attributes will be affected
  7. To exclude your selected attributes from the filter, click on the tick above the criteria labelled All selected to change it to All EXCEPT.
    • This can speed up filter assignment if there are far more attributes to include than exclude. It also helps to keep information about the logic of the object brief and easy to understand.
    • This illustrated example filters for all Entity Types except for those using Platform 1 northbound (“P1 NB” component of the Entity Type names):
  8. Click OK to save the filter settings.